<!DOCTYPE html>
<html>
  <head>
    <meta name="creator" content="mantohtml v2.0.1">
    <title>cupsctl(8)</title>
  </head>
  <body>
    <h1 id="cupsctl-8">cupsctl(8)</h1>
    <h2 id="cupsctl-8.name">Name</h2>
<p>cupsctl - configure cupsd.conf options
</p>
    <h2 id="cupsctl-8.synopsis">Synopsis</h2>
<p><strong>cupsctl</strong>
[
<strong>-h</strong>
<em>server</em>[<strong>:</strong><em>port</em>]
] [
<strong>-E</strong>
] [
<strong>-U</strong>
<em>username</em>
] [
<strong>--</strong>[<strong>no-</strong>]<strong>debug-logging</strong>
] [
<strong>--</strong>[<strong>no-</strong>]<strong>remote-admin</strong>
] [
<strong>--</strong>[<strong>no-</strong>]<strong>remote-any</strong>
] [
<strong>--</strong>[<strong>no-</strong>]<strong>share-printers</strong>
] [
<strong>--</strong>[<strong>no-</strong>]<strong>user-cancel-any</strong>
] [
<em>name=value</em>
]
</p>
    <h2 id="cupsctl-8.description">Description</h2>
<p><strong>cupsctl</strong> updates or queries the <em>cupsd.conf</em> file for a server. When
no changes are requested, the current configuration values are written to the
standard output in the format &quot;name=value&quot;, one per line.
</p>
    <h2 id="cupsctl-8.options">Options</h2>
<p>The following options are recognized:
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-E</strong><br>
Enables encryption on the connection to the scheduler.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-U </strong><em>username</em><br>
Specifies an alternate username to use when authenticating with the scheduler.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-h </strong><em>server</em>[<strong>:</strong><em>port</em>]<br>
Specifies the server address.
Note: This option must occur before all others.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--</strong>[<strong>no-</strong>]<strong>debug-logging</strong><br>
Enables (disables) debug logging to the <em>error_log</em> file.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--</strong>[<strong>no-</strong>]<strong>remote-admin</strong><br>
Enables (disables) remote administration.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--</strong>[<strong>no-</strong>]<strong>remote-any</strong><br>
Enables (disables) printing from any address, e.g., the Internet.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--</strong>[<strong>no-</strong>]<strong>share-printers</strong><br>
Enables (disables) sharing of local printers with other computers.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--</strong>[<strong>no-</strong>]<strong>user-cancel-any</strong><br>
Allows (prevents) users to cancel jobs owned by others.
</p>
    <h2 id="cupsctl-8.examples">Examples</h2>
<p>Display the current settings:
</p>
    <pre>
    cupsctl

</pre>
<p>Enable debug logging:
</p>
    <pre>
    cupsctl --debug-logging

</pre>
<p>Get the current debug logging state:
</p>
    <pre>
    cupsctl | grep '^_debug_logging' | awk -F= '{print $2}'

</pre>
<p>Disable printer sharing:
</p>
    <pre>
    cupsctl --no-share-printers
</pre>
    <h2 id="cupsctl-8.known-issues">Known Issues</h2>
<p>You cannot set the Listen or Port directives using <strong>cupsctl</strong>.
</p>
    <h2 id="cupsctl-8.see-also">See Also</h2>
<p><strong>cupsd.conf</strong>(5),

<strong>cupsd</strong>(8),

<br>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
</p>
    <h2 id="cupsctl-8.copyright">Copyright</h2>
<p>Copyright &copy; 2020-2024 by OpenPrinting.
  </body>
</html>
